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Introducing the Text Formatter 


The Text Formatter will produce finished printed or plotted documents from text files you have stored 
in the HP-75. This is useful for creating memos, form letters, personal letters, short reports, and other 
documents. 


The process of creating a document consists of two steps: 


1. Creating the text file. 
2. Running the program FORMAT?S (which is part of the Text Formatter module). 
As you compose a text file, you can embed (include) text formatter commands in it. (You can also 


embed commands after the text file has been written.) These embedded commands will determine how 
your formatted, printed (or plotted) document will look. 


When you run the program FORMAT 75 on a text file, that file gets printed out according to the 
formatter commands you have embedded in it. These commands can do such things as start new para- 
graphs, set margins, number pages, and so on. After becoming familiar with the Text Formatter you 
will soon be able to produce documents “on the run”—while riding home or waiting for an appoint- 
ment. Using the Text Formatter, you can be sure that the final document will look neat and well 
structured. 


The Text Formatter has a number of features for formatting various documents, including: 


e Paragraph breaks and indentation. 

e Spacing, margin, and page length adjustments. 

e The ability to insert information from a distribution list of names into another document. 
¢ Plotter control. 


e The ability to merge files. 
Included in the box with your Text Formatter module and this manual are: 


e Two prerecorded magnetic cards. 
e One keyboard overlay. 
e A Quick Reference Card. 
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How to Use This Manual 


The information in this manual assumes that you have read sections 1, 2, 3, and 9 of the HP-75 
Owner’s Manual. Specifically, you should know how to create and edit a text file (section 3), and how to 
connect, assign, and operate your printer and/or plotter (section 9 and the owner’s manual for the 
printer or plotter). 


This manual is both a learning tool and a reference tool. Read through section 1 (“Getting Started”) 
for an overview of what the formatter does. Read and work through the examples in section 2 (“Using 
Text Formatter Commands”) to find out how to operate the formatter. Later, when you need brief 
descriptions and reminders for the text formatter commands, refer to the Quick Reference Guide or the 
Command Summary and Index at the back of this manual. This index includes page references, as does 
the Subject Index. 


There are also several appendices for your reference: 


e Appendix A, “Owner’s Information,” includes warranty and service information. 


e Appendix B is “Error and Status Messages.” If the Text Formatter cannot carry out a certain 
command, it will print out an error message. Refer to appendix B for an explanation of the mes- 
sages that the Text Formatter can generate. (For other messages, see the HP-75 Owner’s Manual.) 


e Appendix C, “Text Formatter Applications,” contains two examples of documents that can be pre- 
pared by the Text Formatter. One of them, the file F755 TART, is recorded on a magnetic card 
included with the formatter module. 


e Appendix D, “Typing Aids (F?SKE‘'S),” describes the set of key redefinitions supplied as 
F?5KE%S on a magnetic card included with the module. A corresponding overlay for the key- 
board is also included. (Information on redefining the keyboard is in section 10 of the HP-75 
Owner’s Manual.) You can perform HP-75 functions faster if they are assigned to keys, because 
then you don’t have to type them out. 


e Appendix E, “The Help File (F 7 SHELF),” shows a list of the Text Formatter commands. This file 
is supplied on a magnetic card included with the module. 

e Appendix F, “The Prompt File (F 7S EMF T),” describes the use of F 7 SFEMPT, a file on a mag- 
netic card included with the module. The prompt file allows you to create personalized messages 
for the Text Formatter to use. 








e Appendix G, “Advanced Printing Techniques,” describes the use of escape sequences to obtain dif- 
ferent kinds of typeface (boldface, compressed, expanded, etc.). 


e Appendix H, “Calling FORMAT? from a BASIC Program,” tells you how to set up another pro- 


= 


gram to run FORMAT? 5, the text-formatting program. 
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Section 1 


Getting Started 


Installing and Removing the Text Formatter Module 


The Text Formatter module can be plugged into any of the three ports on the front edge of the com- 
puter. 





CAUTIONS 





© Be sure to turn off the HP-75 (press [SHIFT ][ATTN]}) before installing or removing any module. If there 
are any pending appointments, type a1 .arm of f [RTN) in EDIT mode to prevent the arrival of 
future appointments (which would cause the computer to turn on). If the computer is on or if it turns 
itself on while a module is being installed or removed, it might reset itself, causing all stored informa- 
tion to be lost. 














© Do not place fingers, tools, or other foreign objects into any of the ports. Such actions could result in 
minor electrical shock hazard and interference with pacemaker devices worn by some persons. Dam- 
age to port contacts and internal circuitry could also result. 





To insert the Text Formatter module, orient it so that the 
label is right-side up, hold the computer with the keyboard 
facing up, and push in the module until it snaps into 
place. During this operation be sure to observe the precau- 
tions described above. 





To remove the module, use your fingernails to grasp the lip on the bottom of the front edge of the 
module and pull the module straight out of the port. Install a blank module in the port to protect the 
contacts inside. 
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What the Text Formatter Does 


The Text Formatter module contains a program, FORMAT?5, that will process a text file and print 
out a document. FO.FMAT?5 looks for special commands in your text file that tell it what to do. 
There are two steps to creating a document: 


1. Prepare the text file by including or inserting the desired text formatter commands. (Once these 
commands are part of your file, they are termed embedded.) 


2. Run FORMAT?S (that is, type run '‘format?5' and press (RTN)). 





To illustrate this process, enter a sample file and run FORMAT?5 as shown below. For now, don’t 
worry about what all the commands and numbers mean—these will be explained in the following sec- 
tion. This example will show you different ways the Text Formatter can prepare a document. 


Input/Result 


Creates a text file name SAMPLE and displays the 
catalog entry for this file. (Your time and date 
will vary.) You can use upper- or lower-case 
letters. 


edit'sample',t 








auto (RIN) For convenience, execute the Al/T( command to 
provide line numbers automatically. This starts 
the numbering at line 10. A space is added after 
each line number. 





Enter the following file as it is listed below. Remember that you must press (RTN] after typing each line 
to process that line and enter it in memory. For any shifted characters, hold down while press- 
ing the other key. For example, to get “, press (SHIFT)[%]. If you make a typing mistake,use [BACK] to 
correct it. This example is for demonstration, so don’t worry about what the embedded formatter com- 
mands (like “({E) mean—they will be explained in the next section. You can type the formatter com- 
mands in upper- or lower-case. (“CE is the same as “c.) You do not have to include a space at the 
end of a line—the formatter automatically puts a space between the words at the end of one line and 
the beginning of the next. (So don’t break a word across two lines, because it will be interpreted as two 
different words.) 








:10 “ce FORMATTER DEMONSTRATION Centers title. 

:20 “sk 3 “pa This is a demonstration of the Skips three lines, starts new paragraph. 
:30 Text Formatter for the HP-75. 

:40 You can build a text file in memory 

:50 without worrying about the actual 

:60 structure of your text. In fact, 

:70 you can even put just one word 
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:80 on 

:90 each 

:100 line. 

:110 “pa When printing, the formatter reads Starts new paragraph. 
:120 embedded commands to decide when to start a new 

:130 paragraph, set margins, or alter other 

:140 aspects of the final document. 


(When you are done entering this file, you can stop the automatic numbering by pressing [ATTN].) 





Notice that the lines in your text file can be as short or as long as is convenient for you—you can key 
in up to 95 characters per line. In this manual, you will see that most of the lines in the text files are 
close to the length of one display (32 characters). This is a convenient way for you to easily review the 
contents of one line.* 


Connecting to a Printer 


The work that you have done up to now can take place anywhere: at your desk, while traveling, or out 
in the field. When you get back to your printer, connect it to the HP-75 and prepare to produce your 
printed document. (Section 9, “HP-IL Operations,” of the HP-75 Owner’s Manual explains how to 
connect a peripheral device, how to assign it a device code, and how to declare the printing device to the 
computer.) 


The examples in this manual use the HP 82905B Impact Printer (option 248 for HP-IL). For other 
printers, refer to their owner’s manuals. 


HP-IL Connection. After attaching the printer or plotter to the HP-75 with HP-IL cables, use the 
ASS 1GH10 command to assign the device code, and then use the FR IHTER I'5': device code ' 
command to declare the printing device. 






Paper Alignment. For various formatting operations to function properly, each formatting job must 
begin with the printer’s printhead aligned with the top of a page; that is, the printhead should be on 
the first line of a sheet after the perforation. 


When your formatting job is done and you want to tear off the last sheet of fanfold paper from the 
printer, form-feed the paper before tearing it off. (Take the printer off-line first by pressing the ON 
LINE button, press the Form Feed button, then press the ON LINE button again.) The form-feed 
advances the paper for removal, moving it until the printhead is on the first line of a new sheet. This 
will ensure that your printer paper is always correctly aligned for formatting. 


*If you prefer to set a line length shorter than 95 characters, you can set the HP-75 MAF:GIN command to beep as a reminder 
that you are approaching the end of the line. Refer to section 2 in the HP-75 Owner’s Manual. 
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Running FORMATS 
You are now ready to run the Text Formatter: 
Input/Result 2 


run'format?s'! The Text Formatter prompts you for the name of —~ 
the file you want to format and the number of 
copies you want. 


FILE, # OF COPIES: SAMPLE 





Notice that, by default (if you don’t change it), the file to be formatted will be the current edit file 
(that’s SAMFLE here), and the number of copies will be one. The cursor blinks at the first letter of 
the file name as a signal to change it if you want to. 


For this example, simply press to begin formatting. 


Input/Result 


Indicates that your file is being formatted and 
printed. 





Indicates that printing is complete. 





If you get an error message instead of the above displays, refer to appendix B in this manual (“Error 
and Status Messages”) or appendix E in the HP-75 owner’s manual (“Error Conditions”), as necessary. 
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Your final document will be printed as follows: 





FORMATTER DEMONSTRATION 


This is a demonstration of the Text Formatter for the 
HP-75. You can build a text file in memory without worrying 


about the actual structure of your text. In fact, you can 
even put just one word on each line. 

When printing, the formatter reads embedded commands toa 
decide when to start a new paragraph, set margins, or alter 
other aspects of the final document. 





Plotting With the Text Formatter 


If you want to produce text on a plotter—such as for overhead transparencies, covers, or posters—you 
can also use the Text Formatter to format a text file for plotting. (The plotter must be a printer 
compatible with HP-IL, such as the HP 7470A opt. 003 plotter.) 


To prepare a text file for formatting and plotting, you use the same formatter commands as usual, with 
the addition of the L. command to specify pens and character formation. Refer to the “ (slide) 
command for instructions and examples for text-formatted plotting (page 31). For a quick demonstra- 
tion on the plotter, connect a plotter, assign it a device code (like ' : F 1 '), declare the plotter to be the 
printer (printer is ':—1'), and add the following lines to SAMPLE. For instructions on 
connecting the plotter to the HP-IL loop, refer to section 9 in the HP-75 Owner’s Manual. 








5 “sl 16 10 
115 “sl 140 
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Input/Result 


rerun! formaty?S' (RIN 


FILE, # OF COPIES: SAMPLE 


RIN 








FORMATTER DEMONSTRATION 


This is a demonstration of the Text 
Formatter for the HP-75S. You can build a text 


File in memory without worrying about the actual 
structure of your text. In fact, you can even 
put just one word on each line. 

When printing, the formatter reads embedded 
commands to decide when to start a new paragraph, 
set margins, * alter other aspects of the final 
document. 





Section 2 
Using Text Formatter Commands 


This section describes how to use the Text Formatter commands in general, and then specifically dis- 
cusses the meaning and use of each command. For an alphabetical listing of the commands, refer to the 
Command Summary and Index at the back of the manual. 


General Syntax for Commands 


Text formatter commands are put into a text file either while the text file is being written or after- 
wards. All the commands are two-letter mnemonics (such as “lH for margin), which you can type in 
upper- or lower-case letters. You can string together more than one command on one line, and you can 
follow commands) with text, but any commands on a line must appear before any text on the same line. 
Any command appearing after text will be interpreted as text. 


The single line 
:20 “sk “pa This is a demonstration of the 
is equivalent to the following three lines: 
:20 “sk 


121 “pa 
:22 This is a demonstration of the 


The Command Character (*) 


Every individual formatting command in a text file must be preceded by the command character, the 
circumflex (*). It is the command character that signals the presence of a command to the Text 
Formatter. You can redefine the command character from the “ to another character by using and 
storing the prompt file, appendix F. 
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Parameters 


Each command can be followed by one or more parameters, such as numbers or file names. If a param- 
eter is optional, then you don’t have to supply that parameter. If you don’t supply an optional param- 
eter, then the computer uses a default value for that parameter.* 


If there are two optional parameters, you can omit them both or omit just the second one, but you 
cannot omit just the first one. 


5 Oma Uses the default parameters 13 (left 
margin) and 72 (right margin). 


5 ma 8 Uses the default parameter for the right 
margin, so the margins are 8 and 72. 


5 “ma 8 68 Sets margins to columns 8 and 68. 


Separating Parameters. If you give more than one parameter for a command, the parameters must 
be separated from each other by one or more spaces. However, you do not need a space between a 
command and a following parameter. 


:5 “mal 9 Sets margins to columns 1 (left) and 9 
(right). 

:5 4ma1g9 Sets margins to 19 (left) and, by default, 
72 (right). 


Default Values. A default value takes effect until some other value is explicity given. The default 
values for all the conditions and commands are re-established each time you run FORMAT?5S. They 
are then altered by specific commands in your text file. Therefore, any conditions that you set up in 
one text file (like margins, spacing, page numbering, and so on) will not have any effect on any other file. 


Numeric Values. Numeric parameters must be integers. The range for a parameter can depend on 
other conditions; for instance, it is not possible to set a paragraph to indent further than the right 
margin! 


Text Input and Output 


The Text Formatter ignores any trailing (ending) spaces in a line of text from your text file. It also 
ignores the first space after the line number. (Depending on the text mode, it can ignore all leading— 
that is, beginning—blanks.) It automatically adds a space between the last word from one line and the 
first word from the next line in the file. The Text Formatter will not divide or hyphenate words be- 
tween lines. 


* A default condition or parameter is one that is in effect “by default” unless you specifically change or redefine that condition. 
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Typing Conventions in This Manual 


Each command described in this section includes a syntax box, which includes the following 
information: 


The command name appears in dot matrix type. 


The type of parameter for the command is in italic type. Parameters must be supplied in 
[ the order shown. 





“TAL [left margin [right margin]] 





tf 


If the parameters are optional, they are enclosed in brackets. Nested brackets, as in this example, 
indicate a hierarchy: the value for the left margin can be given without the value for the right 


margin, but the right margin cannot be given without the left margin. 





Note that items for you to type in exactly as shown are printed in (101T MATEI type, while items 
that are merely descriptions are printed in italic type. Specific keys on the HP-75 are shown in key 
boxes, such as (RTN]. To get a shifted or a control character, you must hold the [SHIFT] or [CTL] key while 
pressing the desired character key, such as [SHIFT ][*] (which represents the same keystrokes as (*]), or 
CTL] [BACK] (which represents [ESC]}). 






























































Modes of Formatting Text 


There are four text modes for formatting lines of text. They are set by the commands “F I (Fill), “lJ 
(Justify), “© (Copy), and “CE (Center). Both Fill and Justify are filling operations, while both Copy 
and Center are copying operations. It is optional to include a page-test parameter with a text mode 
command. 





Filling Lines and Justifying Lines (“F I, *!!) 


When the Text Formatter produces lines of text, it fills up every line of text it prints out with as many 

whole words as will fit. To produce one line of formatted, printed text, the formatter will use as much 

text as necessary from your text file, normally ignoring any extra spaces in the text file. This is why it 
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doesn’t matter how much or how little you write on a line in your text file: when FORMAT? runs, it 
fills up each line as much as it can, given its margins. The left margin is justified. 
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The two text-filling modes are Fill mode and Justify mode. 





| “ET [page-test parameter] | 








| “ILD [page-test parameter] | 





e Fill mode (*“F 1) is the default text mode for the text formatter. Everytime you run FORMAT? S, 
Fill mode is automatically set. Fill mode operates as described above. 


e Justify mode (*.!\!) will justify the right margins by adding spaces between words. Otherwise, it 
operates like Fill mode. 


In either of these modes, a single space following a period or colon is expanded two spaces. 


If you specify a page-test parameter, these commands will also check how many lines remain on the 
page being printed. The page-test parameter checks for a minimum number of lines. Page testing is 
explained below (page 21) under “Testing for the End of the Page.” 


Example: The following short text file shows the effects and differences of Fill mode and Justify 
mode. (Remember: to create a named text file, type ¢dit ' file name' , tet [RTN].) 











:10 This sentence 

:20 is 

:30 printed in Fill 

:40 mode. 

:50 You can see how a sentence is 
:60 printed without extra spaces. 
:70 “ma 13 43 “ju 

:80 This sentence is a short 

:90 demonstration of justification 
:100 between some narrow margins. 
:110 You can see that the lines 
:120 have extra spaces to make them 
:130 right-justified. 
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The formatted, printed output is: 


This sentence is printed in Fill mode. You can see how a 
sentence is printed without extra spaces. 

This sentence is a short 

demonstration of justification 


between some narrow margins. 
You can see that the lines have 
extra spaces ta make them 
right=-justified. 





Keeping Words Together (Fixed Space). If you want to be sure that a particular pair of words 
won’t be split between lines during printing, or you don’t want the justification procedure to add extra 
spaces between them, put a fixed-space character instead of a space between the two words. The fixed- 
space character is the tilde, ~, but you can define it to be another character by using the prompt file 
(described in appendix F). (To display the ~, press [CTL] [x].) 


For instance, if you want to be sure that the phrase “HP-75 Computer” is printed all on one line and 
(in Justification mode) without any extra spaces between the two words, type it into your text file as 
HF-?S~Computer. The ~ character will not be printed; it will appear as a space. 


Duration. When Fill mode or Justify mode is set, it lasts for the duration of that particular run of 
FORMAT? S, unless you change it. (Fill mode is automatically set each time FORMAT? 5 runs.) How- 
ever, these two text modes are suspended by the text-copying modes, copy (“() and center (“E). 
After copying or centering ends (as explained below under “Copying and Centering Lines”) the 


formatter sets Fill mode. 
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Breaking. There are several commands that involve a break in the output of the current printing line. 
Printing then resumes on a new line. For instance, when a command to skip lines (““) occurs, the 
Text Formatter stops adding words to the current line of print, performs the skip, and resumes printing 
the subsequent text onto a new printed line. 





—Z 
As an example, in Justification mode the last line of a paragraph will not be justified. This is because 
the output for that line will be broken by a subsequent “FA, , or “0 command (as examples). 
Also, the very last line from a file is not justified. 





The commands that cause a break in output and start new lines of print are: 


“ET Fill “PEL Paragraph 
IL Justify L. Slide 
“MA Margin Skip 


“FID. Advance Page 








You can use “™ & to cause a break in printing without any other effect. 


Copying Lines and Centering Lines (“0, “CE) 


There are times when you won’t want the Text Formatter to “fill up” your lines, but instead will want 
it to print out a line of text exactly as it appears in the text file. This is called copying a line, and is 
done by setting “CO or “CE. 


The two text-copying modes are Copy mode and Center mode. 


[page-test parameter] 
[ “ITE [page-test parameter] 


These commands will also test for the end of the page if you specify a page-test parameter. Refer to 
“Testing for the End of the Page” below. 








e Copy mode (*"'() causes the subsequent text to be printed line-by-line as it appears in the text 
file. Any spaces between words will be preserved. Leading spaces are also preserved (except for the 
first space after the line number), though trailing spaces are not. 


e Center mode (*E) copies (just like “() and centers subsequent text, line by line. In addition, 
both leading and trailing spaces are ignored. 


Duration. Copy or Center mode remains in effect for subsequent lines until the occurrence of a “F I, 
“JU, “OO, “CE, “FA, or ~TA command. Following a “FA (paragraph) or “TF (tab) command, Fill 


ey 


mode is set. Copy and Center modes are not restored after the execution of “F'Fi or “TR. 
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Example: 


:10 These words appear Fill mode is set. 

:20 in 

:30 Fill mode. 

:40 “sk 1 “coThese words appear Skips one line and sets Copy mode. 
:50 in 

760 Copy mode. 

:70 “sk 1 “ce Center just this line. Sets Center mode. 

:80 “fi This is the next line in Sets Fill mode. 

:90 Fill mode. 


The formatted, printed output is: 


These words appear in Fill mode. 


These words appear 
in 
Copy mode. 


Center just this line. 
This is the next line in Fill mode. 





Line Length. If a line in the text file is too long to be printed within the given margins, only as much 
of the line as fits on one line will be printed. To indicate that, the last two characters printed on that 
line will be question marks. 


Testing for the End of the Page 


If you want to be sure that a section of text (like a table or a short paragraph) will not be split between 
two pages of output, you can include an optional page-test parameter with any one of the text mode 
commands. The page-test parameter represents the number of lines that you want to keep together. 
This activates the page-testing function to check that there will be enough room for that many lines 
before the end of the page. If there is enough room (at the time of printing), then the formatter contin- 
ues to print out text. If there is not enough room, then the page advances before the formatter prints 
more text. 
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In order for page testing to function properly, the page-length setting must be correct (see “FL, page 
26), and the formatting job must begin with the printer’s printhead aligned with the top of a page. (It 
should be set on the first line after a perforation. Refer also to page 11 in section 1.) The following 
example uses “F I +4 to check that there are at least four lines left on the page before printing out a 
short paragraph. In this example, Fill mode is set initially, so “FI 4 does not change the current text 
mode. 


:10 “pa Start of paragraph one. Fill mode on. 
:20 This paragraph continues for 
:30 several lines. 


:70 End of paragraph one. Checks for the end of the page within 
:80 “fi 4 “pa Begin a new paragraph four lines. If there are less than four 
:90 with this sentence. lines available, then the page advances 


before the next paragraph is printed. 


Indenting Lines 


Two other commands that affect the format of a line are paragraph (“F'Fi) and tab to column (*TF). 
Either of these commands will cancel Copy or Center mode. After the formatter makes the indentation 
for the new paragraph or a tab, Fill or Justify mode is set. Fill mode is set if the last text mode was 
Fill, Copy, or Center. Justify mode is only set if it was the text mode just before the “FA or “TA 
command. 


Starting a New Paragraph (*F-) 





“FFL [number of spaces to indent] 





The default number of spaces is 5 or the last value used. 


This command starts a new line of printed text, indenting it the given number of spaces. If no number 
is given, then the indentation will automatically be the same as it was the last time “FA was used, so 
you don’t have to specify the indentation except to change it. If you don’t ever specify an indentation, 
five spaces are used. 


“FF indents from the current left margin, so you can specify a negative indentation to start the line to 
the left of the current margin. If, for example, the left margin is set to 8 and you use a “FAH ~ 5, then 
the first character of the next line will start in column 3. “FA & will not indent and will skip a line 
instead. (“FA with other values will not skip a line.) 


— 
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“PF includes an implicit page test for two lines. This avoids having just the first line of a paragraph 
appear at the bottom of a page. 


After indenting, “FA restores Fill or Justify mode (whichever was last in effect). If Copy or Center 
mode was last in effect, “FA cancels it and sets Fill mode. 


Example: 


:10 End of the old paragraph. 

:20 “pa 7 Beginning of the new paragraph. 
:30 Notice that only the first line of the 

:40 paragraph is indented. No lines are 

:50 skipped. 


The printed, formatted output is: 





End of the old paragraph. 
Beginning of the new paragraph. Notice that only the 
first line of the paragraph is indented. No lines are 


skipped. 





Indenting by Tab to a Column (*TA) 


TF column number 


The “TA command indents the printed text to the given column position on the same line, if possible. 


After tabbing, “THA restores Fill or Justify mode (whichever was last in effect). However, the current 
printed line (the one being tabbed) is never justified. If Copy or Center mode was last in effect, “TA 
cancels it and sets Fill mode. 
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Example: 


:10 From: Marian Card 

:20 “ta 50 Date: 5/18/83 

:30 “sk To: Mary Powell 

:40 “ta 50 Subject: Book orders 

:50 “sk 2 | am sorry to report that the text 
:60 that we ordered from the bookstore is 
:70 out of print. We will need to select 

:80 another text and place a new order 

:90 as soon as possible. 


The formatted, printed output is: 


From: Mary Fowell Date: 5/18/83 


To: Marian Card Subject: Book orders 


foam sorry to report that the text that we ordered from the 
bookstore is out of print. We will need to select another 
text and place a new order as soon as possible. 





If the given column number is less than the current column position in the printed line, then text 
output will begin in the given column on the next printed line. 


Formatting a Page 


The Text Formatter commands covered under this topic are concerned with formatting the output of a 
page as a whole, rather than individual lines of text. These commands are “!fi (set margins), “FL 
(page length), “=F (set line spacing), “5. (skip lines), “PH (page numbering), and “AL! (advance 
page). 





WD 


Setting Margins (fA) 
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Fi [left margin [right margin] ] 


The default left margin is 13, the default right margin is 72. 


Each time you run FORMAT? 5, the left and right margins for the printed page are automatically set 
to columns 13 and 72. These same default values are set by the command “!A without any param- 
eters. Or, if only the left margin is set, the right one is automatically 72. 


Example: 


:10 “ju This text is printed within 

:20 the default margins of 13 and 72. 

:30 “ma 17 65 “sk 

:40 You can highlight a block of text by 
:50 setting margins to 17 and 65, as in 
:60 this example. When you have completed 
:70 the text that you wish to highlight, 

:80 you can use the MA command with no 
:90 parameters to reset the margins. 

:100 “ma “sk 

:110 This is the last sentence. It is 

:120 printed within the default margins 
:130 again. 


The printed, formatted text is: 


This text is printed within the 


72. 


You can highlight 
margins to 17) and 
you have 


highlight, you can 
parameters to reset the margins. 


This is the last sentence. 


margins again. 


block 
as in this example. 


completed the text 


Resets margins to 17 and 65. 


Resets margins to 13 and 72. 


default margins of 13 and 


of text by setting 
When 
that you wish to 
the MA command with no 


It is printed within the defauit 
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The margin numbers refer to column numbers on the page. Although 80 columns is the normal width 
of a page, you can specify a right margin up to 132. The left margin can be as low as 1. 


Page Length (“F i.) 


“PL. [page length [top margin [bottom margin] ] ] 


The default page length is 66, the default top margin is 6, and the default bottom margin is 6. 


The “FL command tells the formatter how many lines of print are possible per page (the total page 
length), and how many lines to leave as margins on the top and bottom of the page. The usual, 
8%” x 11” sheet is 66 lines long for an HP 82905B printer. If you don’t set the top and bottom mar- 
gins, the Text Formatter automatically skips the first and last six lines on each page. 


The specifications for page length are necessary for the proper operation of end-of-page testing, page 
numbering, and paper advancement while a file is being formatted and printed. For the formatter to 
count the page length properly, the formatting job must begin with the printer’s printhead aligned with 
the top of a sheet of paper.* (You should set the printhead at the first line after a perforation. Refer to 
page 11 in section 1.) 


If you are using a sheet-feed printer, for which you manually insert each sheet of paper, then use a 
negative number for the page length parameter (for example, -66). The HP-75 will then display this 
message each time a new sheet is needed: 





You can then insert a new sheet of paper, aligning the printhead on the first possible line of the paper, 
and press to continue. 


If your printer already automatically skips a certain number of lines for top and bottom margins, then 
the Text Formatter will skip additional lines according to the margins that are set. Therefore, you 
should know what your printer does for top and bottom margins. (Check the printer’s manual.) 


*The “FL command should be set at the beginning of the text file so that it will be set when the printer is at the beginning of the 
page. Otherwise, “FL could cause the printer to advance to the next page. 
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Examples: Suppose you have a sheet-feed printer, printing 60 lines per page, that begins printing on 
the fourth line of each page. You want one-inch margins at the top and bottom of the page, and the 
printer prints six lines per inch. Use this page-length command: 


:10 “pl -60 3 6 Since this printer already skips three 
lines at the top of a page, your top 
margin parameter should be 3 (not 6), 
creating a total margin of six lines. 


Printers With Perforation Skipping. Some types of thermal printers that use roll or fanfold paper 
(like the HP 2671A printer) have a perforation-skip feature. This causes the printer to advance past 
the perforations in the paper, skipping the last and first three lines on each sheet of paper. These 
printers also usually print 60 lines per page (by default). To obtain a one-inch (six-line) margin at the 
top and bottom of each page, use this page-length command: 


10 “pl 60 3 3 
Roll-Fed Printers. You can avoid page-length considerations entirely by specifying the page length as 


“FL &, This is desirable, for instance, if you are using a roll-fed printer, such as an HP 82162A 
printer. 


210 “pl 0 Do not specify top and bottom margins in 
this case. 





Line Spacing (* =F) 








* [number of lines] 





The default number of lines is 1. 





The “=F command sets the spacing between lines of printed text output. You can set a value from 1 to 
5, with 1 for single-spacing, 2 for double-spacing, and so on. 





F does not cause a break in printing, that ‘is, it does not cause the printing to stop on one line and 
start again on a new one. 


Example: 
:10 “coThese lines are Since this is in Copy mode, the formatter 
:20 printed single-spaced. would preserve any spaces between a 
:30 “sp 2Now we have switched command and the text. 


:40 to double-spacing, 
:50 “spnow back to single-spacing, 
:60 which is the default condition. 
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The formatted, printed output is: 





These lines are 
printed single-spaced. 
Now we have switched to 







double~-spacing, 











now back to single-spacing, 
which is the default condition. 





Skipping Lines (* 








The default number of lines is 1. 





The “SK command causes a break in printing (printing stops on the current line of output and starts 
again on a new one) and then skips the given number of lines on the formatted page. 


If more lines are specified for skipping than there remain on the page, then the printer simply advances 
to the top of the next sheet. 










You can use “SE & to cause a break in printing without skipping any subsequent lines. 


Page Numbering (* Ft) 


“EH [page number] 


The default page number is the current one. 





The Text Formatter always keeps track of the total number of printed pages being produced. The “FH 
command causes the formatter to print the page number on the second line from the bottom of each 
page. (The page numbers are not printed unless you use “FH.) 
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If “FH is used without a parameter, then the current page number, as counted by the formatter, will be 
printed. Otherwise, you can specify a starting page number for the formatter. 


To stop the printing of page numbers, use “FH &. The formatter will still keep track of the number of 
pages being printed, however. If you resume printing page numbers with “FH (no parameter), then the 
page numbers will be the same as if all the printed pages had been numbered. 


In order for page numbering to function properly, the page-length setting must be correct (see “FL, 
page 26), and the formatting job must begin with the printer’s printhead aligned with the first line 
after a perforation. (See page 11 in section 1.) 


Example: 


:10 “pn “coThis is the first sentence of page one. 

:20 “sk 52This is the last sentence of page one. 

:30 This is the first sentence of page two. 

:40 This page will not be numbered. 

:50 “sk 51 “pn OThis is the last sentence of page two. 
:60 This is the first sentence of page three. 

:70 “pn “sk 52This is the last sentence of page three. 


The formatted, printed output is: 


This is the first sentence of page one. 


This is the last sentence of page one. 
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This is the first sentence of page two. 
This page will not be numbered. 


This is the last sentence of page two. 








This is the first sentence of page three. 


This is the last sentence of page three. 
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Advancing the Page (* AL) 





“AD 








The “Fifi command causes a break in printing the output, and advances the printer to the first line for 
printing on the next sheet of paper. In order for this to work properly, the page length setting must be 
correct (refer to “FL on page 26), and the formatting job must start with the printhead aligned with 
the first line after a sheet’s perforation (as explained on page 11 in section 1). If you have set up the 
formatter for a manual, sheet-feed printer by using a negative parameter for the “FL. command (such 
as F'L. —6&), then “AL will also cause the message PLEASE INSERT FAGE... to appear (See 
page 26.) 


Formatting for a Plotter ( 








“SL. [pen number [character size [character slant] ] ] 











The default pen number is 1, the default character size is 3, and the default character slant is 0. 


The “SL (slide) command will format text for printing on an HP-IL plotter (like the HP 7470A). This 
is especially useful for creating text for slides or transparencies for overhead projection. 


The “Sl. command must appear as the first command in your text file. It initializes the plotter to start 
using the specified pen in the upper left corner of the sheet of paper. It will form the characters accord- 
ing to the specified character size and slant. (For more information about the parameters for pen num- 
ber, character size, and character slant, refer to the owner’s manual for the plotter.) 





In addition, “SL resets the page length parameter (46) and the margins (1 and 65) as default param- 
eters for plotting. 
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Example:* 
110 “sl 1 8 5 “sk 2 “ce Initializes the plotter. 
:20 TITLE FOR SLIDE 
30 “sl 15 0 “fi This “SL command changes the 
:40 This text is formatted for character size and slant. 


:50 the HP 7470 plotter with the 

:60 Text Formatter. 

:70 “sp 2 The Text Formatter can make: 
:80 “ta 10 * Slides for meetings. 

:90 “ta 10 * Status summaries. 

:100 “ta 10 * Title pages for reports. 


The formatted, plotted output is: 


PRE Pair. Si Tie 


This text is formatted for the HP 7470 
plotter with the Text Formatter. The 


Text Formatter can make: 


* Slides for meetings. 


* Status summaries. 


* Title pages for reports. 





* As mentioned in section 1 (under “Plotting With the Text Formatter”), before running FORMAT?S for plotting, connect the 
plotter to the HP-IL loop, assign a device code to the plotter, and declare the plotter as the printer. (Refer also to section 9 in the 
HP-75 Owner’s Manual.) 


Section 2: Using Text Formatter Commands 33 





Altering * Parameters 


If you use “SL without specifying the pen number and/or character size, the default values shown 
above will be used. If you do not specify the character slant parameter, then the slant will remain 
unchanged (it will not go back to zero). 


If you want to alter only one or two of any of the parameters and don’t want to alter the others, you 
don’t have to re-specify them all: 


e To keep the pen number and/or character size unchanged, use the value 0. A zero keeps a pen 
number or character size parameter from changing back to the default value. 


¢ To keep the character slant unchanged, do not specify anything. (This is because a 0 value for the 
slant will change the slant to zero.)* 


For example, to change the character slant to 5 without changing the current pen number or character 
size, use: 


30 *sl0 05 


Character Size and Character Slant 


Size. Use the following table for reference in selecting a suitable character size for your plotted text: 





Char. Size Chars./Line Lines/Page 





98 68 
65" 46° 
49 34 
39 27 
32 23 


28 20 
24 17 
21 16 





“The default value. 





When you change the character size, the margins automatically adjust to accommodate the maximum 
number of characters that will fit on a line. The page length automatically adjusts to accommodate the 
maximum number of lines that will fit on a page. 


Note: When you change from a smaller to a larger character size, it is possible for one line to overlap 
the previous line. To avoid this, include a “S. (skip lines) command after the command to change the 
character size. 






* If you change the “SL parameter(s) from the original, default values (1 3 0) and then use a “SL command without any param- 
eters, the last character slant you used will still be preserved. 
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Slant. The character slant parameter specifies the angle from the vertical line from which the char- 
acter “leans”. A positive slant makes the character lean forward, while a negative slant makes the 
character lean backward. The character slant does not affect the horizontal strokes in a character. The 


possible range of values for the character slant is from —80 to 80 (degrees). However, the practical 
range is from —30 to 30. 


Example: 


10 “sl 1 2 —30 

:20 “coThis is *“SL 1 2 —30 

30 “sl 1 3 —20This is “SL 13 —20 
:40 “sl 1 4 —10This is “SL 1 4 —10 
:50 “sl 1 5 OThis is “SL 150 

:60 “sl 1 6 10This is “SL 1 6 10 

:70 “sl 1 7 20This is “SL 1 7 20 

:80 “sl 1 8 30This is “SL 1 8 30 

:90 “sl 1 9 40This is *SL1 9 40 


The formatted, plotted output is: 


Amie As “SL 1 2-2 

Wis is “SL 1 3 -20 

This is “St 1 4 -10 
This is “SL 15 0 


This is “SL 1 6 10 
laze te Sh fF 2G 


Ihre te “Sk df & Ge 
VIII BS Vol FG Ze 
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Formatting Combinations of Text Files 


There are two text-formatter commands that enable you to format several text files at one time. The 
“ME (merge) command in a text file “calls” another file and merges it to the first one. The “CL 
(distribution list) command in a text file specifically “calls” and incorporates entries from a names file. 


Merging Files (*!E) 


If you re-use certain standard pieces of information—like a letterhead or form letter—it is useful to 
keep the standard information in a single text file, and then call that file from any other file that needs 
the standard information. This is called merging files. You can merge files anytime you want to com- 
bine the information from two different text files. 


1E file name 


A “ME command must be either the only or the last command on a line. No text or commands can 
follow a “!E command on the same line. 





The ““ME command causes the Text Formatter to suspend formatting of the current file and begin 
formatting the specified, called file. Upon reaching the end of the called file, the formatter resumes 
formatting the original file from the text line after the “ME command. 


The merging function can be nested. That is, one file can call a second file for merging, the second file 
can call a third file for merging, and so on, up to a fifth file. An error will occur if you try to nest a 
series of more than five files. 


Example: The following three text files will merge during formatting. The merging is nested three 
files deep. 


:10 “pa 0 This is FILE1 calling FILE1. 
:20 *me file2 
:30 “pa This is the end of the example. 


110 FILE2. Now FILE2 will call FILE. 
:20 FILES. 

:30 “sk “me file3 

:40 Now we will return to FILE1. 


:10 “pa This is a second paragraph. FILES. 
:20 It is all part of FILES. 
:30 Now we will return to FILE2. 
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When you run FURMAT?S, be sure that the file name specified is FILE1. (F ILE1 will then call 
F ILE2, which then calls FILE.) The printed, formatted output for FILE 1 is: 


This is FILE1 calling FILE2. Now FILES will call FILES. 


This is a second paragraph. {t is all part of FIL 


we will return to FILES. Now we will return toa FIL 


This is the end of the example. 





Using a Distribution List (* CL) 


A distribution list—familiar to those who write memos—is a list of people who should receive a copy of 
a certain memo or report. The “LIL (distribution list) command will integrate a series of names (a 
distribution list) from a names file into a body of text from a source text file. 





“CL. file name of names file [ , replacement character] | 
The default replacement character is * ((CTLJ(7)). 





The “CL command creates personalized memos or form letters. When the source file is formatted, 
“(iL will produce personalized copies for different people without altering the source text file. Wher- 
ever the source text file uses the replacement character (the default * or the character specified in the 
“CL command), the formatter will substitute information from a name entry in the names file. The 
formatter will go through the list in the names file and produce as many different copies of the source 
file as there are name entries in the names file. Within any one copy, the same information is inserted 
everywhere the replacement character (*) is encountered in the source file. (To display *, hold 
and press (7].) The “iL command must specify the name of the file that has the list of name entries 
you want to use. You need to specify a replacement character only if you want to use something other 
than ~ 





210 “dl staff Calls the names file STAFF for the 
distribution list. 


— 


NN 
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A “OL command must be either the only or the last command on a line. No text or command can follow 
a “OL command on the same line. 


The Names File. To build a names file, simply create a new text file. Use one name entry per text 
line. The name entry can be as little as a first name or as much as an entire name and address. You 
can also divide the name entry into fields by separating parts of the entry with a replacement character 
(*). This allows the source file to call for different parts of a name entry, instead of using the entire 
name entry for each name insertion. (This is shown in the example below.) You can define up to nine 
fields in a name entry. 


The Replacement Character. The normal (default) replacement character is “ (the accent grave). 
To obtain this character, hold and press (7). If you want to define a different character for the 
replacement character, simply specify it along with the “[iL_ command. 


The replacement character is used in both the names file that is called by a “DL and in the source file 
that contains the “CL. 


The replacement character used in the corresponding source and names files must be the same. 


e In the names file: use * to define fields in the name entries. Each entry in a file should have the 
same kinds and number of fields, but you can define a field as you wish. (In other words, if you 
define a middle name as the second field in one entry, then all entries should use a middle name in 
the second field.) 


If you don’t define any fields, then the entire name entry will be one field. You can define up to 
nine fields. 


:10 Becky Melissa Hansen This defines three fields: field 1 is the 
first name, field 2 is the middle name, 
and field 3 is the last name. 


e In the source file: place * in the source text file everywhere that you want an entry from the 
distribution list to be inserted. If you want to use only certain fields (which must be defined in the 
names file) of the name entry, then specify a field number after the replacement character. For each 
field you want the formatter to insert, use “field number. 


30173 If the current name entry is Beck y™ 
Melissa*Hansen, then this line in 
the source file will be printed as 
Becky Ha re 





The replacement character is recognized as a replacement character only in the text-filling modes (Fill 
and Justify). In the text-copying modes (Copy and Center), the replacement character will be printed as 
is any other character, with no special meaning. 
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Example: The following source text file, HITE, uses the following names file, = TAFF, to produce a 
personalized memo from a distribution list. 


:10 Becky Hansen File STAFF. The ~ defines fields for the 
:20 Glen Mason first and last names. 
:30 Elaine Peterman 


210 “dl staff File HOTE. Calls STAFF. 
:20°To: ~ This will insert the entire name entry 
into the formatted copies. 

:30 “sk 1 From: Judy Martin Every copy will read 

140 “sk 1 From: Judy Martin. 

:50 “1, there will be a sales The *1 will insert just the first name 

:60 meeting tomorrow at 3:00. field into the formatted copies. 
When you run FLRMAT?S, be sure the file name specified is HO1TE (the source file), not STAFF 
(the names file). 


The formatted, printed output for HOTE is: 


Vos BKecky Hansen 
From: Judy Martin 


Becky, there will be a sales meeting tomorrow at 


To: Glen Mason 


From: Judy Martin 


Glen, there will be a sales meeting tomorrow at 3: 
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Toa: Elaine Feterman 


From: Judy Martin 


Elaine, there will be a sales meeting tomorrow at 3:00. 





Example: Multiple fields in a names file can be used to set up the the address portion of a standard 
business letter. Suppose the source text file LETTEF uses the names file HAMES. 


:10 John” Smith” ABC Company 1735 Main . This shows just one entry from the 
St. City State~ ~60637 names file HAMES. It has six fields 
: defined in it.* 





Yor 
:10 “dl names File LETTER, which calls HANES. 
:20 “ju “ta 45 November 16, 1983 Sets Justify mode so that the body of the 
:30 “sk 2°12 letter will be justified. 
:40 “sk 0 “3 7 & causes the printer to move to the 
:50 *sk 0 4 next line. 
:60 “sk 0 “5, “6 
:70 “sk 2 Dear 1: 
:80 “sk 2 As we discussed in our 
:90 last telephone conversation, 
. The body of the letter continues. 
Na 


* If you put two fixed-space characters between the state and the zip code, the printed version will maintain two spaces before the 
zip code (refer to page 19). 
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The formatted, printed output for LETTER. is: 





November 16, 1983 


John Smith 
> Company 
3 Main St. 
State 60637 


Dear John: 


As we discussed in our last telephone conversation, 





© 








Appendix A 


Owner’s Information 


Maintenance 


The Text Formatter module does not require maintenance. However, there are several precautions, 
listed below, that you should observe. 





CAUTIONS 
© Do not place fingers, tools, or other foreign objects into any of the ports. Damage to plug-in module 
contacts and the computer's internal circuitry may result. 


Turn off the computer (press 


If a module jams when inserted into a port, it may be upside down. Attempting to force it further may 
result in damage to the computer or the module. 





(ATTN]) before installing or removing a plug-in module. 


e Handle the plug-in modules very carefully while they are out of the computer. Do not insert any objects 
into the module connecter socket. Always keep a blank module in the computer’s port when a module 
is not installed. Failure to observe these cautions may result in damage to the module or the 
computer. 





Limited One-Year Warranty 


What We Will Do 


The Text Formatter is warranted by Hewlett-Packard against defects in materials and workmanship 
affecting electronic and mechanical performance, but not software content, for one year from the date 
of original purchase. If you sell your unit or give it as a gift, the warranty is transferred to the new 
owner and remains in effect for the original one-year period. During the warranty period, we will repair 
or, at our option, replace at no charge a product that proves to be defective, provided you return the 
product, shipping prepaid, to a Hewlett-Packard service center. 
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What Is Not Covered 


This warranty does not apply if the product has been damaged by accident or misuse or as the result of 
service or modification by other than an authorized Hewlett-Packard service center. No other express 
warranty is given. The repair or replacement of a product is your exclusive remedy. ANY OTHER 
IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS IS LIMITED TO THE ONE- 
YEAR DURATION OF THIS WRITTEN WARRANTY. Some states, provinces, or countries don’t 
allow limitations on how long an implied warranty lasts, so the above limitation may not apply to you. 
IN NO EVENT SHALL HEWLETT-PACKARD COMPANY BE LIABLE FOR CONSEQUENTIAL 
DAMAGES. Some states, provinces, or countries do not allow the exclusion or limitation of incidental 
or consequential damages, so the above limitation may not apply to you. 


This warranty gives you specific legal rights, and you may also have other rights which may vary from 
state to state, province to province, or country to country. 


Warranty for Consumer Transactions in the United Kingdom 


This warranty shall not apply to consumer transactions and shall not affect the statutory rights of a 
consumer. In relation to such transactions, the rights and obligations of Seller and Buyer shall be 
determined by statute. 


Obligation to Make Changes 


Products are sold on the basis of specifications applicable at the time of manufacture. Hewlett-Packard 
shall have no obligation to modify or update products once sold. 


Warranty Information 


If you have any questions concerning this warranty, please contact an authorized Hewlett-Packard 
dealer or a Hewlett-Packard sales and service office. Should you be unable to contact them, please 
contact: 


e In the United States: 


Hewlett-Packard 
Corvallis Division 
1000 N.E. Circle Blvd. 
Corvallis, OR 97330 
Telephone: (503) 758-1010 
Toll-Free Number: (800) 547-3400 
(except in Oregon, Hawaii, and Alaska) 


e In Europe: 


e In other countries: 


Service 


Service Centers 
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Hewlett-Packard S.A. 
7, rue du Bois-du-Lan 
P.O. Box 
CH-1217 Meyrin 2 
Geneva 
Switzerland 
Telephone: (022) 83 81 11 


Note: Do not send products to this address for repair. 


Hewlett-Packard Intercontinental 
3495 Deer Creek Rd. 
Palo Alto, CA 94304 
U.S.A. 
Telephone: (415) 857-1501 


Note: Do not send products to this address for repair. 


Hewlett-Packard maintains service centers in most major countries throughout the world. You may 
have your product repaired at a Hewlett-Packard service center any time it needs service, whether the 
unit is under warranty or not. There is a charge for repairs after the one-year warranty period. 


Hewlett-Packard computer products normally are repaired and reshipped within five (5) working days 
of receipt at any service center. This is an average time and could vary depending on the time of year 
and work load at the service center. The total time you are without your product will depend largely on 


the shipping time. 
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Obtaining Repair Service in the United States 
The Hewlett-Packard United States Service Center for battery-powered computational devices is lo- 


cated in Corvallis, Oregon: 


Hewlett-Packard Company 


Corvallis Division Service Department 


P.O. Box 999 
Corvallis, OR 97339, U.S.A. 
or 
1030 N.E. Circle Blvd. 
Corvallis, OR 97330, U.S.A. 


Telephone: (503) 757-2000 


Obtaining Repair Service in Europe 


Service centers are maintained at the following locations. For countries not listed, contact the dealer 


where you purchased your unit. 


AUSTRIA 

HEWLETT-PACKARD Ges.m.b.H. 
Kleinrechner-Service 
Wagramerstrasse-Lieblgasse 1 
A-1220 Wien (Vienna) 
Telephone: (0222) 23 65 11 


BELGIUM 

HEWLETT-PACKARD BELGIUM SA/NV 
Woluwedal 100 

B-1200 Brussels 

Telephone: (02) 762 32 00 


DENMARK 
HEWLETT-PACKARD A/S 
Datavej 52 

DK-3460 Birkerod (Copenhagen) 
Telephone: (02) 81 66 40 


EASTERN EUROPE 
Refer to the address listed under Austria 


FINLAND 
HEWLETT-PACKARD OY 
Revontulentie 7 

SF-02100 Espoo 10 (Helsinki) 
Telephone: (90) 455 02 11 


FRANCE 

HEWLETT-PACKARD FRANCE 
Division Informatique Personnelle 
S.A.V. Calculateurs de Poche 
F-91947 Les Ulis Cedex 
Telephone: (6) 907 78 25 


GERMANY 
HEWLETT-PACKARD GmbH 
Kleinrechner-Service 
Vertriebszentrale 

Berner Strasse 117 
Postfach 560 140 

D-6000 Frankfurt 56 
Telephone: (611) 50041 


ITALY 

HEWLETT-PACKARD ITALIANA S.P.A. 
Casella postale 3645 (Milano) 

Via G. Di Vittorio, 9 

1-20063 Cernusco Sul Naviglio (Milan) 
Telephone: (2) 90 36 91 


NETHERLANDS 

HEWLETT-PACKARD NEDERLAND B.V. 
Van Heuven Goedhartlaan 121 

NL-1181 KK Amstelveen (Amsterdam) 
P.O. Box 667 

Telephone: (020) 472021 


NORWAY 

HEWLETT-PACKARD NORGE A/S 
P.O. Box 34 

Oesterndalen 18 

N-1345 Oesteraas (Oslo) 
Telephone: (2) 17 11 80 


SPAIN 

HEWLETT-PACKARD ESPANOLA S.A. 
Calle Jerez 3 

E-Madrid 16 

Telephone: (1) 458 2600 


SWEDEN 

HEWLETT-PACKARD SVERIGE AB 
Skalholtsgatan 9, Kista 

Box 19 

S-163 93 Spanga (Stockholm) 
Telephone: (08) 750 20 00 


SWITZERLAND 
HEWLETT-PACKARD (SCHWEIZ) AG 
Kleinrechner-Service 

Allmend 2 

CH-8967 Widen 

Telephone: (057) 31 21 11 


UNITED KINGDOM 
HEWLETT-PACKARD Ltd 
King Street Lane 
GB-Winnersh, Wokingham 
Berkshire RG11 5AR 
Telephone: (0734) 784 774 
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International Service Information 


Not all Hewlett-Packard service centers offer service for all models of HP products. However, if you 
bought your product from an authorized Hewlett-Packard dealer, you can be sure that service is avail- 
able in the country where you bought it. 


If you happen to be outside of the country where you bought your unit, you can contact the local 
Hewlett-Packard service center to see if service is available for it. If service is unavailable, please ship 
the unit to the address listed above under “Obtaining Repair Service in the United States.” A list of 
service centers for other countries can be obtained by writing to that address. All shipping, 
reimportation arrangements, and customs costs are your responsibility. 


Service Repair Charge 


There is a standard repair charge for out-of-warranty repairs. The repair charges include all labor and 
materials. In the United States, the full charge is subject to the customer’s local sales tax. 


Computer products damaged by accident or misuse are not covered by the fixed repair charge. In these 
cases, repair charges will be individually determined based on time and materials. 


Service Warranty 


Any out-of-warranty repairs are warranted against defects in materials and workmanship for a period 
of 90 days from date of service. 


Shipping Instructions 


Should your product require service, return it with the following items: 


e A completed Service Card, including a description of the problem. 


e A sales receipt or other documentary proof of purchase date if the one-year warranty has not 
expired. 


The product, the Service Card, a brief description of the problem, and (if required) the proof of pur- 
chase date should be packaged in adequate protective packaging to prevent in-transit damage. Such 
damage is not covered by the one-year limited warranty; Hewlett-Packard suggests that you insure the 
shipment to the service center. The packaged product should be shipped to the nearest Hewlett- 
Packard designated collection point or service center. Contact your dealer for assistance. 
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Whether the product is under warranty or not, it is your responsibility to pay shipping charges for 
delivery to the Hewlett-Packard service center. After warranty repairs are completed, the service center 
returns the product with postage prepaid. On out-of-warranty repairs in the United States and some 
other countries, the product is returned C.O.D. (covering shipping costs and the service charge). 


Further Information 


Service contracts are not available. Computer products circuitry and design are proprietary to Hewlett- 
Packard, and service manuals are not available to customers. Should other problems or questions arise 
regarding repairs, please call your nearest Hewlett-Packard service center. 


Technical Assistance 


The keystroke procedures and program material in this manual are supplied with the assumption that 
the user has a working knowledge of the concepts and terminology used. Hewlett-Packard’s technical 
support is limited to explanations of operating procedures used in the manual and verification of an- 
swers given in the examples. Should you need further assistance, you may write to: 


Hewlett-Packard 
Corvallis Division Customer Support 
1000 N.E. Circle Blvd. 
Corvallis, OR 97330 


Dealer and Product Information 


For additional product information, refer to the accessory brochure that was included with your HP-75, 
contact your local Hewlett-Packard dealer, or call toll-free in the United States (800) 547-3400. In 
Oregon, Alaska, and Hawaii, call (503) 758-1010. 


Appendix B 
Error and Status Messages 


The Text Formatter produces certain messages under specific conditions. Some of these are merely 
status messages, while others occur in response to an error. An incorrectly typed or constructed com- 
mand will produce an error message. In most cases, an error message does not halt text-file printing. 


Status and error messages can appear either in the HP-75 display or on the printed output. 


Displayed Messages 


These messages, listed in alphabetical order, can appear in the display: 


The Text Formatter has completed printing and 
the HP-75 is now ready for the next task. 


#FILE filename HOT FOUND The specified file is not in memory. 


FILE, # OF COPIES: filename, 1 Requests the name of the text file to use as input 
to the Text Formatter, and the number of copies 
that you want printed. 


FORMATTING ... The Text Formatter is running. 


$¢¢NOT ENOUGH MEMORY #44 There is not enough available memory to run the 
text formatter. You may need either to purge some 
files or execute CLEAR WARS (see section 5 in 
the HP-75 Owner’s Manual) to make room. 


If a sheet-feed printer or a plotter is in use, 
change the paper and press [RTN] to continue. 
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Printed Messages 
The following messages, in alphabetical order, can appear on the printer: 
EEEMULTIPLE OL1STRIBUTION LIS 


Only one distribution list file may be used in any particular document. 





“OL file name ##% 


#EEPARANETER ERROR: “command first parameter [second parameter] *#% 


A valid command name has been used with an invalid parameter, such as setting the left margin 
in a higher-numbered column than the right margin. The command and parameters you supplied 
are printed. 


#EETOO MAY MERGE FILES: “ME filename ##% 
The nesting limit of merge files has been reached. Up to five levels of merging are permitted. 
SEEUHEHOWH COMMAND: “command £## 


A command has been mistyped. Formatting will continue without altering any of the modes in 
the Text Formatter. 


Appendix C 
Text Formatter Applications 


Memo Writing 


If you are going to write a lot of short memos, you can save considerable typing time by using the 
BASIC program F #55 TAFT, which is included on a magnetic card in the Text Formatter package. (A 
listing of this file is given after the following example.) Load this program into memory as described in 
the HP-75 Owner’s Manual, section 8, using the [OF CARO TO command. You should edit line 80 
of this file and insert your name (as described in section 3 of the HP-75 Owner’s Manual). 


When you execute this program, it will prompt you for standard information for the memo (the file 
name, the name of the person the memo is for, and the subject), create the text file for the memo, fill in 
your name and address and the date, and then leave you to write the body of the memo. 


Memo Example 


Example: Suppose you’re writing a memo to Rich Duncan about light fixtures. Your name should be 
assigned to the variable !1# in line 80 of FF SS TAFT. (Edit the file F* SSTAFT and fetch line 80.) 


Input/Result 


run'f? Setar t' (RIN The prompt can be » or ;:. 


File name Enter the file name for your memo. For this 
example, use LIGHTS. 








lights (RT 











To: @ Enter the name of the person to whom you are 
sending the memo. 





Rich OGurcan (RTN 











Subject: © Next, enter the subject of the memo. 
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Input/Result 





Lights (RTN 











LIGHTS 5 13:88 12 2 This creates the text file | 1GHTS, which already J 
includes five lines (from 10 to 50) for the head of 
the memo. 





Now go to the end of the file and add the body of the text. 


Input/Result 





Fetches the last line in the file. (Hold [SHIFT] and 
press [+ ].) 








(SHIFT ] (+ 




















Starts automatic line numbering at line 60. You 
are now ready to add text. 





RIN] sito ([RTN 

















Add the following lines of text to the LIGHTS file and then run FORMATS to format it. 


:60 The light fixtures that we ordered for the 

:70 new hallway are going to arrive three weeks 

:80 earlier than we anticipated. Unless you have 

:90 any objections, | would like to store them in the 
:100 back of Warehouse B until they can be installed. 





Press [ATTN] to stop the automatic line numbering. 
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Input/Result 





rerun! formatrs' RTN 











FILE, # OF COPIE LIGHTS 





RIN 








The formatted, printed memo is:* 


From: my name Date: S2/12/2 


To: Rich Duncan Subject: Lights 


The light fixtures that we ordered for the new hallway are 
going to arrive three weeks earlier than we anticipated. 
Unless you have any objections, I would like to store them 
in the back of Warehouse B until they can be installed. 





*The HP-75 interprets the date with the year first, then month, then date. 


This listing shows the F 7 = 
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FFSSTART Listing 








? TART program:* 


>10 INPUT 'File name?’;F$ 

>20 ON ERROR GOTO 60 

>30 ASSIGN # 1 TO F$,TEXT 

>40 ON ERROR GOTO 70 

>50 READ # 1 ; A$ 

>60 BEEP @ DISP “ ***FILE ALREADY EXISTS *** @ 
END 

>70 OFF ERROR 

>80 M$='my name’ 


>90 INPUT 'To: ’;T$ 

>100 INPUT 'Subject: ';S$ 

>110 PRINT # 1,10 ; “ From: “&M$ 

>120 PRINT # 1,20 ; * “TA 50 Date: “&DATE$ 
>130 PRINT # 1,30 ; “ “SK To: “&T$ 

>140 PRINT # 1,40 ; “ “TA 50 Subject: “&S$ 
>150 PRINT # 1,50 ; “ “SK 2” 

>160 EDIT F$ @ END 


Asks for file name. 
Sets error trap. 
Assigns file buffer. 


Attempts to read from the named file. 
If it can read from that file, it displays 
an error and ends the program. 
Cancels the ON ERROR condition. 
You should substitute your name for 
‘ty mame! in this program. 

Asks you for the addressee. 

Asks you for the subject of the memo. 
Lines 110 to 150 transmit text and 
formatter commands to the named text 
file. 


Moves edit pointer and ends program. 


Club Membership Roster 


This example produces a letter to be sent to all the members of a bowling league. It uses the “(ML 
(distribution list) command to call a names file (where the members’ names and dues are stored) and 
print out a letter reminding the members of the next meeting and any outstanding dues. (Review the 
“LiL. command before using these files.) The listing below is for a names file called MEMBERS 
containing club members’ names, addresses, and outstanding dues. 


:10 Jeff Igelman’3174 Broadway Anytown, Anystate 40896" 10.00 


:20 Carol Johnson’ 274 McKinley Ct. Anytown, Anystate 40897 °30.00 
:30 Martha’ Woodstone 1205 Fir Street’ Anytown, Anystate 40896" 15.00 


* If you have redefined the commands in F7SFEMPFT, then you would need to modify this file to correspond with F 7 SF RMF T. 


WH 


The next listing is for a text file named ECHL to call the names file NEMNBE 
for the bowling club. 
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= and produce the letter 


Note: This file uses escape codes to produce different typefaces on the printer. /f you are not familiar 
with the use of escape sequences, refer to appendix G, “Advanced Printing Techniques.” 


:10 “dl members 
:20 “ma 1 40 


30 “coESC&k1S 

:40 “ce Emerald Bowling League 

:50 “ma 

60 “coESC&k9S 

:70 “ce Devoted to Excellence in Bowling 
:80 Having Fun Since 1969 

:90 “coESC&k0S 

2100 “ju 2 9/14/83 

:110 “sk 2°12 

:120 “sk 0 “3 

1130 “sk 0 “4 

:140 “sk 2 Dear °1: 

:150 “pa 0 This is the first newsletter of our 
:160 fall season. As you may be aware, our 
:170 summer tournament was a big success! The 
:180 big winners are: 

2190 “coESC&k9S 

:200 “ta 25 Name 

:210 “ta 45 Average 

1220 “coESC&k0S 


Calls MEMEBERS for the name entries. 
Sets narrow margins so expanded print 
will fit. 

Escape code for expanded print.* 


Restores margins to 13 72. 
Escape code for emphasized (bold) print.* 


Escape code for normal print.* 

Sets Justify mode. 

Prints first, last names.t 

Prints address, city, state, and zip code. 


Personalizes greeting. 
Starts a paragraph without indentation; 
skips a line. 


Sets bold print.* 


Sets normal print.* 





* To store an escape sequence given as ESC&k1S, type (SHIFT 











17R), then 





ESC) ((CTL 














BACK]). This will display the escape char- 























» press (CTL }(7}. 





acter . Then type #:: 15. A copying mode (Copy or Center) should precede the escape sequence to cause a break in the output. 
For more information, see appendix G. 


+ To get 
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:230 “ta 20 John Photenhauer 

:240 “ta 47 205 

:250 “ta 20 Bob Andersen 

:260 “ta 47 197 

:270 “ta 20 Jerry Moore 

:280 “ta 47 196 

:290 “pa Our congratulations to everybody 

:300 who made the summer so much fun! 

:310 “pa It’s now time to get ready for the fall 

:320 season. If you haven't already signed up 

:330 to get involved, this is the time. To 

:340 keep your membership current, you need 

:350 to make sure that your dues are paid up. 

:360 In your case, ©1, the membership dues Inserts names from names file. 
:370 owed are $75. 

:380 Please fill out the enclosed sign-up 

:390 sheet so that we know which time you 

:400 would like to bowl. 

:410 “sk “ce New Members Centers heading. 
:420 “pa We would like to welcome two New paragraph (resumes in Fill mode). 
:430 new members to the club. They are Dave 

:440 Anderson and Martha Smith. Dave is new 

:450 to bowling, and is eager to learn. In 

:460 just three months, he’s brought his 

:470 average up to 144, so watch out, 

:480 everyone! Martha comes to us from the 

:490 Jake's Pizza team in Millersburg, and 

:500 has an average of 195. 

:510 “sk “ce Monthly Meeting Centers heading. 
:520 “pa Our next meeting and open bowl New paragraph (resumes in Fill mode). 
:530 will be on the last Friday of September. 

:540 We'll be at the City Bowling Lanes at 

:550 8:00 pm. 

:560 Let’s see everybody on hand for a fun 

:570 evening of bowling! 


The formatted, printed output for EOL will be three identical memos, each with different name 
information. The first copy will be: 
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-ald Howling Leaque 


Devoted to Excellence in Bowling 
Having Fun Since 1969 


Jeff Igelman 
S174 Broadway 
stown, Anystate 40896 


Dear Jeff: 
this 1s the first newsletter of our fall season. AS you may 


be aware, our summer tournament was a big success! The big 
winners are: 


Name Average 


John Fhotenhauer 205 
Bob Andersen 197 
Jerry Moore 196 


Our congratulation to everybody who made the ammer se. much 
Fur! 


It’s now time to get ready for the tall season. If you 
haven*t already signed up to get involved, this is the 
time. To keep your membership current, you need to make 
eure that your dues are paid up. In your ca Jeff, the 
membership due ed are $10.00, Flease fill out the 
enclosed cign-up sheet so that we know which time you would 
like to bowl. 


New Members 


We would like to welcome two new members to the club. They 
are Dave Anderson and Martha Smith. Dave is new to bowlina, 
and is eager to learn. In just three months he’s brought 
average up to 144, so watch out, everyone! Martha com 
from the Jake’s Fizza team in Millersburg, and has 


Monthly Meeting 


next meeting and open bowl will be on the last Friday 
September. We’ll be at the City Lanes at 8:00 pm. Let’s 
see everybody on hand for a fun evening af bowling! 








Appendix D 


Typing Aids (F # 









Among the magnetic cards that come with the Text Formatter is one with the file F 7 SKE‘ S recorded 
on it. The FF SEES file contains a set of key redefinitions that you can use as typing aids—as 
shortcuts for entering the Text Formatter commands. For instance, the keystroke sequence “= is 
redefined to (hold (CTL) while pressing (A]). Note that all of the key redefinitions use control 
sequences. 





The redefined sequences are: 





Command Redefined Control Sequence 





CTL 








ANo|aya 
| 


SEEGER R2RERERHE 


io 
4 
a 





ei 
4 
im 


Q 
4 
a 











° 
4 
a 











° 
4 
a 





° 
4 
a 








° 
4 
a 








CTL) (RU 
“ta CTL} (TAI 


z 














You can store this file in memory (as explained in section 8 of the HP-75 Owner’s Manual), then copy 
it to the HP-75 KE‘ file for use when entering a text file (see section 10 in the HP-75 Owner’s 
Manual). If you have already redefined some keys for use in other applications, and wish to preserve 


those redefinitions, use the procedure shown here: 





First, save the current k ='= file in a temporary 
file. 


rename keys toa ‘keygtemp 
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;' to keys Next, copy the redefinitions for the Text 
Formatter to k ys. 


The keyboard is now redefined and ready for use. You might find it convenient to use the provided 
keyboard overlay to remind you of the new definitions of the keys. The redefined keyboard is: 


ieee ee 

pa gla talpe ee lipe 

cu Bw ee ee eo oe Bs) 
HE OOO Oe Oe eo 

sor ee Bs Bot) 




















Input/Result 








12 CTLI(P For instance, press (CTL](P] to get “pa 





























CTL] (RUN A big timesaver is the new sequence for 
run'format?s' 





FILE, # OF COPIES? file name. 1 





When you are done using the Text Formatter and want to restore your original key definitions, save 
FFSEE%'S and restore KEY’ TEMP to the KES file: 





rename ke. ta 'FF5k i 


iT 
i 


iT 
uw 
ny 


iT 
i 


rename ‘keytemp' to k 


For more about redefining your keyboard, refer to section 10 of the HP-75 Owner’s Manual. 


Appendix E 


The Help File (F F2HELF 


) 


One of the magnetic cards included with the Text Formatter contains the “help” file, F 7 SHELF. You 
can use this file for reference and reminder since it contains a list of the Text Formatter commands and 
their parameters. (This same information is in the Quick Reference Card for the Text Formatter.) This 
can be used for quick reference while you’re “on the go”. To use the file, you can either list it (LIST or 
PLIST) or EQIT it and use (FETCH) to find a particular command. Load this file from the 
card into the memory of your HP-75, as explained in section 8 of the HP-75 Owner’s Manual. The text 
of FF SHELF is: 


:10 HP-75 Format75 Commands 
:20 “ad advance page 

:30 “ce [n] center mode 

:40 “co [n] copy mode 

:50 “dl filename[,R$] select distribution list 
:60 “fi [n] fill mode 

:70 “ju [n] justify mode 

:80 “ma [13 [70]] set margins 
:90 “me filename merge file 
:100 “pa [5] new paragraph 
1110 “pl [66[ 6[ 6]]] page size 
:120 “pn [n] page numbering on 
:130 “sk [1] skip lines 

:140 “sl [1[ 3[0]]] slide 

:150 “sp [1] set line spacing 
:160 “tan tab to column n 


In this file, [n] refers to an optional, numeric parameter. Numerals in brackets (like [13 [70]]) refer to 
default values for those optional parameters. 
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The Prompt File (F 





PRIME 





One of the magnetic cards included with the Text Formatter contains the “prompt” text file, 
FFSPRMPT. Once you load this file into the memory of your HP-75 (see section 8 of the HP-75 
Owner’s Manual), you can edit it line by line and use it to change any command or message the Text 
Formatter uses. That is, you can redefine the letters or messages used and recognized by the Text 
Formatter. This is strictly an option for you; you do not have to define your own commands and 
messages. 


The file F 7 SP RMF T contains messages, command mnemonics, and special characters that are used by 
FORMAT ?S. Whenever you run FORMAT?5, it will look for the prompt file in memory. If it finds 
the prompt file, it will use any definitions the prompt file contains. This allows you to change com- 
mands, prompts, error messages, and command characters to suit your personal taste. For instance, if 
you would rather the paragraph command were “FF instead of “FA, just fetch line 10 of FF SPRMFT 
and change the third and fourth characters to “FF. 





Important Note: There is no protection in the Text Formatter against invalid changes you might make to 
F* SP RMF T. lf you change or delete a line, unpredictable results can occur. If line 10 does not exist, 
the prompt file will be purged. If line 10 exists but is not exactly 32 characters long, this line will be 
ignored by FORMAT? 5. (You can re-enter F* SFR T from the magnetic card if you do acciden- 
tally alter or purge FF SPREMFT.) 


The text of FP SPRMPT is: 


:10PNPASPADFICOCESLJUMASKTADLPLME* ~ 
:20NOT ENOUGH MEMORY 
:30FILE, # OF COPIES: 
:40UNKNOWN COMMAND: 

:50TOO MANY MERGE FILES: 
:60PARAMETER ERROR: 
:70MULTIPLE DISTRIBUTION LISTS: 
:80PLEASE INSERT PAGE... 
:Q90FILE “ 

:100” NOT FOUND 
:110FORMATTING... 

:120DONE 
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Rules to follow for FF SFRMFT are: 


e Line 10 must be exactly 32 characters long, but all other lines can be up to 92 characters long. 


e Do not leave any blanks after the line numbers. (If you use automatic line numbering, you will 
need to backspace once.) — 


e Do not change the line numbers. Your new message must be on the same line as the original one. 


e In line 10: characters #1 to #30 must be upper case and must not be numerals, blanks, or the 
command character. 


e In line 10: characters #31 to #32 must not be blanks. It is best not to use numerals or letters for 
these (the command character and the fixed-space character). 


Appendix G 
Advanced Printing Techniques 


Hewlett-Packard printers share a common standard for escape sequences. Escape codes or sequences 
are special keystroke sequences used for controlling printer operations. You include these sequences in 
your text file, just like formatter commands, to control the printer. You can set alternate printing 
modes (such as expanded or compressed print), vertical line spacing, page length, and so on. With a 
little practice, you can learn to enhance the appearance of your documents by using the features that 
your printer provides. For instance, you can emphasize a heading at the top of a page by printing in 
expanded mode, which prints characters at twice their normal width. 


To write an escape sequence in a text file line, you must: 


1. Start a new line and set Copy or Center mode (type “co or “ce). (The text-copying mode is 
necessary to break the output from the previous line. In this way, the escape sequence only affects 
the text that follows it.*) Do not leave a space after the “co or “ce. 











2. Press (SHIFT](I7R]. (This “literalizes” the escape sequence to follow so that the escape sequence 
will be displayed and stored, and not executed.) 

















3. Press [ESC] ((CTL](BACK]). This produces the escape character, », and makes the cursor disappear. 


4. Type the actual escape sequence, such as #:k 15. (The cursor will return.) You must use upper and 
lower cases as they are shown. Be careful to distinguish between 1 (one) and | (lower-case L), be- 
tween 0 (zero) and O (upper-case O). 


A program or file listing will typically indicate an escape sequence as, for example, ESC&k1S. This 
means “the escape sequence &k1S”. To actually enter this sequence, you must type [SHIFT ](1/R] [ESC] 
15. When you first enter this line, the escape character will be visible. However, any print-out or 
subsequent listing of that line will only show S 


























* It is possible to use escape sequences in Fill or Justify mode, but in that case each escape sequence must be both preceded and 
followed by a “SE & command to break output before and after the escape sequence. 
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Example: On the HP 82905B printer, the escape sequence for expanded print is ESC&k1S. Create a 
text file with the following lines and then format it. (To see the effect on the print, you must use an HP 
printer that can use escape sequences.) 


110 *coESC&k1S Begins expanded printing. 
:20 “ma 6 35 Adjusts the margins. 

:30 “ce REPORT TITLE Prints the title. 

:40 “coESC&kOS Restores normal print. 

:50 “ma Restores default margins. 

:60 “sk 2 “fi This report will Begins printing in Fill mode. 


:70 summarize the results of the 
:80 August productivity study. 


The formatted, printed output is: 


REP oR ViTLeE 


This report will summarize the results of the August 
productivity study. 





There are some important points to remember when using escape sequences. When sending escape 
sequences as in the above example, the printer will generate a carriage return and a linefeed. This 
causes the printer to advance a line. The internal line count of the Text Formatter will be incremented 
as well, so your page count will still be accurate. 


The following table summarizes common features that HP printers implement and their escape se- 
quences. For detailed information about your printer, refer to the owner’s manual for that printer. 
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Common Printer Features and Their Escape Sequences 


Vertical 6 lines/inch ESC2 HP 82905A* 
Line ESC&I6D HP 82905B* 
Spacing 





























ESCO 
ESC&I8D 


8 lines/inch HP 82905A 


HP 82905B 



















ESC&HL HP 2671* 
HP 82905B 
HP 2671 


HP 82905B* 


Skip 
Perforation 











ESC&IOL 


Select 
Print Mode 










ESC&knS t+ 









* The default condition for this printer. 


+ Where rn is a number corresponding to the print mode that you want. To select 
a print mode, choose the appropriate number from the following table. 


Note: “I” is a lower-case L. 


Print Mode Numbers 










Normal HP 82162A, HP2631G, 


HP 2671, HP 82905B 


HP 82162A, HP 82905B, 
HP 2631G 








Expanded 





HP 2671, HP 82905B, 
HP 2631G 


HP 82905B, HP 2631G 





Compressed 


Compressed, 
Expanded 










Emphasized* HP 82905B 


For example, to set the HP 82905B printer to Emphasized print mode, use ESC&k9S . You might want 
to redefine some keys for the escape sequences that you use most often. Refer to appendix D in this 
manual and section 10 of the HP-75 Owner’s Manual for further information. 


Appendix H 


= From a BASIC Program 





Calling FORMAT 


You can call FORMAT?S from another BASIC program in the HP-75. This feature is useful, for 
example, when you want to generate documents similar to the applications examples in appendix C, or 
if you want to format several files while you are away from your computer. 


Example: Suppose that you want to format the file SAMFLE (in section 1, page 10) from a BASIC 
program. Make sure that SAMFLE is in memory. Then create a BASIC program named ALLEF, as 
shown: 

Input/Result 

dit'caller',basic (RT Creates the BASIC file CALLER. 








Enter these lines in CALLER: 


>10 edit ‘sample’ 

>20 put chr$(13) This creates a carriage return. 
>30 call ‘format75’ 

>40 disp ‘Back to BASIC!’ 


Input/Result 





brun'tcaller' (RIN Now run CALLER, 











Line 10 makes SAMNFLE the current 
edit file. 
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File, # OF COPIES : By “putting” a carriage-return, the file name is 
entered for you. Refer to the FIT statement in 
the HP-75 Owner’s Manual. 





FORMATTING... Prints SAMPLE. 





FEEOOMHEREE FORMAT?S will finish the job. 


And you have returned to CALLER! 





Command Summary and Index 


This index is an alphabetical listing of all fifteen HP-75 Text Formatter commands. Each entry gives a 
short description of the command: its syntax, its default parameter values, and a page reference to the 
main text. 








A (page 31) 


Advancing the Page. Causes a break in printing the output and advances the printer to the first 
line for printing on the next sheet of paper. 








(SE. [page-test parameter] (page 20) 


Center Mode. Copies (as in Copy mode) and centers the subsequent text from the text file, line 
by line. Leading and trailing spaces on a line are ignored during formatting. Center mode lasts 
untila “FI, “JU, “CO, “FA, or “TA command is executed. “FA or “TA will set Fill mode. 








(20) [page-test parameter] (page 20) 


Copy Mode. Causes the subsequent text from the text file to be copied line by line exactly as it 
appears on the text-file line. Trailing spaces are ignored, but leading spaces are preserved. Copy 
mode lasts until a “FI, “JU, “CE, “FA, or “TA command. “FA or “TA will set Fill mode. 





OL. file name of names file [ . replacement character] (page 36) 
Default value: * ({(CTL}[7]) 














Distribution List. Integrates a series of entries from a names file into a body of text from a 
source text file. Wherever the source text file uses the replacement character, the formatter will 
substitute information from the names file. The formatter will produce as many different 
formatted versions of the source file as there are entries in the names file. Within any one copy, 
the same information is inserted everywhere the replacement character is encountered. 


No text or command can follow a “LiL command on the same line. You can use only one “LiL. per 
text file. 
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In the names file, you can specify fields within each name entry by separating parts with the 
replacement character. 











:18 Becky*Melissa*Hansen This name entry in the names file has three fields. 

118 Dear Ms. This command in the source text file will be 
formatted as Dear Ms. Hanser: 

F I [page-test parameter] (page 17) 


Fill Mode. The default text mode. Fill mode produces full lines of filled, formatted text. Any 
extra spaces in your text file—leading, trailing, or intermediate—are ignored. 





IL! [page-test parameter] (page 17) 


Justify Mode. Causes the formatted text to be filled (as in Fill mode) and right-justified. 





MFI [left margin [right margin] ] (page 25) 
Default values: 13 72 


Margins. Sets left and right margins to the numbered columns. 





ME. file name (page 35) 


Merge. Causes the text formatter to suspend formatting of the current file and begin formatting 
the specified file. You can nest up to five files for merging. No text or commands can follow a “ME 
command on the same line. 





““F'F} [number of spaces to indent] (page 22) 
Default value: the last value used for “FA; or 5 


Paragraph. Starts a new line of printed text, indenting it the given number of spaces. If no 
number is given, it indents the same number as it did the last time “F'Ai was used. After indent- 
ing, “FA restores Fill or Justify mode, whichever was last in effect. If Copy or Center mode was 
last in effect, “FA cancels it and sets Fill mode. 
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A negative indentation parameter will move the beginning of the paragraph to the left of the 
prescribed margin.The command “FA & will not indent and will skip a line instead. 


“FFL includes an automatic page test for two available lines on the sheet. 








FL. [page length [top margin [bottom margin] } ] (page 26) 
Default values: 66 6 6 


Page Length. Tells the formatter how many lines of print are possible per page (the total page 
length), and how many lines to leave as margins on the top and bottom of the page. For a sheet- 
feed printer, use a negative number for the page length parameter. 





“FH [page number] (page 28) 
Default value: the current page number 


Page Numbering. The text formatter always keeps track of the page numbers, but they are not 
printed until the command “FH occurs. Subsequently, “FM 4 will halt the printing of page 
numbers. 





‘aE. [number of lines] (page 28) 
Default value: 1 


Skip Lines. Causes a break in printing on the current line of output, then skips the given num- 
ber of lines on the formatted page. & will cause a break without skipping any lines. 











L. [pen number [character size [character slant] ] ] (page 31) 
Default values: 1 3 0 


Slide. Initializes an HP-IL plotter to produce the text file using the given pen, character size, and 
character slant. The “SL command must be the first command in a file to be plotted. The page 
length is automatically set to 46 and the left and right margins to 1 and 65 (for the default 
parameters). 


The character size parameter can be from 2 to 9. The character slant parameter is practical from 
—30 to +30 (degrees). 


When using the “SL. command, to keep the pen number and/or character size unchanged, use the 
value 0. To keep the character slant unchanged, do not specify a character slant. 
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[number of lines] (page 27) 
Default value: 1 


Spacing. Sets the spacing between lines of printed text output. The number of lines of spacing 
can be from 1 to 5. This command does not cause a break in printing. 





column number (page 23) 


Tab to a Column. Indents the text being printed to the given column position on the same line, if 
possible. After the tab, Fill or Justify mode—whichever one was last in effect—is restored. How- 
ever, the current printed line (the one being tabbed) is never justified. If Copy or Center mode was 
last in effect, “TA cancels it and sets Fill mode. 
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J 
Page numbers in bold type indicate primary reference; page numbers in regular type indicate secon- 
dary references. 
A-B D 
Accent grave (*), 36, 37 Default 
Advancing paper in printer, 26, 31-32 file, 12 
BACK], 10 value, 16 
BASIC program, with FORMAT?5S, 66-67 Demonstration 
Blanks, trailing and leading, 16, 20 Text Formatter, 13 
BOWL, 55 with plotter, 14 
Bowling newsletter, 54-57 Distribution list, 35, 36-40, 54 
Breaking (printing), 20, 27, 31 
E 
Emphasized print mode, 65 
End of page, testing for, 21-22, 23, 26 
Cc Error messages, 7, 49-50 
CALLER, 66 (se). 17 = 
Calling files, 35 character (>), 63 
Cautions, 9, 43 codes, 7, 55, 63-65 i 
Center mode, 17, 20-21, 23 sequences. See codes 
duration of, 20, 23 Expanded print mode, 65 
Character 
control. See Control characters 
size, 31-33 F 
slant, 31-34 
Circumflex (*), 15 
Colon, 18 ; 
aN ia ?SSTART, 7, 51, 58-54 
breaking, 20 Fields, 37 z e 
character: 18 FILE1, FILE2, FILES, 6-86 
embedded, 3, 10 Be NAME; 
parameters, list of, 60 Fill mode, 17-19, 23 
syntax, 15 Filling, 17 
Compressed print mode, 65 Fixed-space character, 19 
Control characters, 17 Form letters, 36 
See also Command character; Escape char- BOREAL ES 
acter; Fixed-space character; Replacement calling, 7, 66-67 
character; running, 10, 12 
Control sequences, redefined, 58 — 
Conventions, in owner’s manual, 17 
Copy mode, 17, 20-21 H 
duration of, 20 Help file, 60 
Copying, 17, 20, 63 HP-IL connection, 11, 13, 32 
CTL], 17, 19 Hyphenation, 16 
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I P 
Indentation, negative, 22 Page 
Indenting end of, 21-22 
by tabs, 23-24 format of, 24 
lines, 22 length, 22, 26-27 
paragraphs, 22-23 negative parameter, 26 
Information numbering, 26, 28-30, 64 
product, 48 width, 24-26 
technical, 48 Page-test parameter, 17, 18 ,22 
Paper 


J-K 





Justification, 17, 20 
Justify mode, 17-19, 23 
Key redefinitions, 58-59 
keus file, 59 


L 





LETTER, 39-40 
Letters, upper- and lower-case, 15 
LIGHTS, 51-53 


Line 
length, 11, 21 
overlap, 33 
Lines 


format of, 22 
skipping, 22, 26, 27, 28 
spacing, 27-28 


M 





Magnetic cards, 3, 51, 58 
Maintenance, 43 
MARGIN, 11 
Margins 
left and right, 25-26 
top and bottom, 26 
MEMBERS, 54 
Memos, 36, 51-53 
Merging files, 35-36 
Messages 
error and status, 49-50 
redefining, 61-62 
Mnemonics, redefining, 61-62 
Mode, text, 17 


N-O 





HAMES, 39-40 

Names file, 35, 36, 37 

Nested files, 35, 50 

Normal print mode, 65 

HOTE, 38-39 

Number of pages, 29 

Owner’s manual, for the HP-75, 7, 11, 51, 58 


advancing, 26, 31-32 
alignment of, 11 
Paper, roll or fanfold, 27 
Paragraph, new, 22-23 
Parameters, 16 
numeric, 16 
optional, 16, 17 
Pen number, 31-32 
Perforation 
page, 22 
skipping, 27, 65 
Period, 18 
Plotting 
with text formatter, 13, 31-34 
parameters, 33-34 
default, 31 
Print mode selection, 65 
Printer 
connecting to, 11 
roll-fed, 27 
sheet-feed, 26, 31 
thermal, 27 
modes, controlling, 63-67 
Printhead, 11 
Prompt file, 15, 19, 61-62 








FUT, 66 

Q-R 

Question mark, 21 

Redefining 
command names, 61-62 
keys, 58-59 

Repair, 46-48 

Replacement character, 36, 37 

RTNJ, 10 








Ss 








MFLE, 66 

Service, 45-48 

SHIFT], 17 

Shifted characters, 17 

Skipping lines. See Lines, skipping 
Slides, formatting, 31-34 
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Source text file, 36, 37 
Space, 19, 20 

character, 16 

extra, 18 

fixed, 19 
STAFF, 38-39 
Status messages, 49-50 
Syntax 

command, 15 

box, 17 


T 





Tab, 23-24 

Text 
copying. See Copying 
file, 18 


files, combining, 35-36 
filling. See Filling 
modes, 17 
default, 18 
Tilde (~), 19 


‘Transparencies, formatting, 31-34 


Typing aids, 58 


V-W 





Vertical line spacing, 65 
Warranty, 43-45, 47 


Words, keeping together, 19 
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